home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 43 / Amiga Format CD43 (1999)(Future Publishing)(GB)(Track 1 of 2)[!][issue 1999-09].iso / -serious- / comms / other / ums / doc / english / files.txt < prev    next >
File List  |  1999-06-14  |  2KB  |  51 lines
  1.  
  2. COPYCOMMAND, DELCOMMAND:
  3.  
  4.   A  first  rudimentary  support for the TempFileName msg-field is
  5. featured by COPYCOMMAND and DELCOMMAND.
  6.  
  7.   They  both specify AmigaDOS shell commands, that are executed by
  8. umsserver. They are invoked with the following commandline:
  9.  
  10.  
  11.   COPYCOMMAND filename msgid umsname resultvar
  12.  
  13.   this must make a copy of the file indicated <filename> and store
  14. this  copy  somewhere. Then it must SET the global environment var
  15. <resultvar>  to  the name of the stored copy. UMS client programms
  16. reading  the  message  must  be able to read the copy of the file.
  17. <msgid>  is  the  MsgID  of  the  message the file is attached to.
  18. <umsname> is the name of the umsserver.
  19.   COPYCOMMAND might try to reduce harddisk usage e.g. by trying to
  20. use hardlinks instead of physical copies whenever possible.
  21.   COPYCOMMAND is invoked every time a message with TempFileName is
  22. stored  to  the  MB. If COPYCOMMAND returns a result code of 10 or
  23. more,  then  the copy is assumed to have failed and the message is
  24. rejected.
  25.  
  26.  
  27.   DELCOMMAND filename msgid umsname
  28.  
  29.   is  supposed  to  delete  the  indicated  file  <filename>. It's
  30. invoked  whenever  a  message  with attached file is deleted, i.e.
  31. during DeleteMsg() or a cleanup.
  32.  
  33.  
  34.   COPYCOMMAND  and  DELCOMMAND  maintain  a  repository  for files
  35. additionally  to  the standard message-base with text-fields. This
  36. repository could be on the same physical filesystem as the MB, but
  37. doesn't need to.
  38.   In analogy to the "$umsmb.<umsname>" environment var for the MB,
  39. the  usage  of  "$umsfiles.<umsname>" is recommended for the files
  40. repository.
  41.  
  42.  
  43.   The  most serious contraint in the crude frist approach probably
  44. is  the  need to provide a repository that is directly readable by
  45. all  UMS clients. If attached files are supposed to also work on a
  46. network,  most  likely  a network-wide, uniformly named filesystem
  47. would  be  required,  since COPYCOMMAND and DELCOMMAND only run on
  48. the  server  machine and no special action for reading messages is
  49. offered.
  50.  
  51.